BlePeriph command group
This command group is available in our standard firmware since version 2.13.
With this command group, you can implement your own BLE peripheral protocol, i.e. your own BLE service (with its own characteristics), which will be advertised by the reader.
Before BLE can be activated via BlePeriph.Enable, you have to define your service via BlePeriph.DefineService. This will create an internal database of characteristics that can be accessed from the BRP host with the commands BlePeriph.WriteCharacteristic and BlePeriph.ReadCharacteristic.
As soon as BLE is activated via BlePeriph.Enable and a BLE Central connects to your reader, it also has access to this internal database of characteristcs. If it connects to the reader, disconnects, or modifies a characteristic, you'll be informed via BlePeriph.GetEvents.
If the BLE peripheral functionality is used in parallel with Mobile ID: It is not possible to use the Mobile ID app and the app to interact with the BLE peripheral on a mobile device simultaneously! If you want to use the BLE peripheral app to interact with the reader, you have to disable the Mobile ID app (e.g. via the Disable app option in Settings ) or vice versa.
WARNING: This command set is not available in all Baltech reader firmware variants.
Status codes
BRP status | BRP Library Error Code | Mnemonic | Description |
---|---|---|---|
0x01 | 0x4B01 (19201) | BlePeriph.ErrNotEnabled | The command could not be executed because BLE is currently not enabled. |
0x02 | 0x4B02 (19202) | BlePeriph.ErrNotConnected | The reader is currently not connected with a BLE central. |
0x03 | 0x4B03 (19203) | BlePeriph.ErrInvalidCharacteristicNdx | The given characteristic index is invalid. |
0x04 | 0x4B04 (19204) | BlePeriph.ErrWriteCharacteristic | The characteristic value could not be written because the given offset or length exceeds the characteristic size. |